home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / misc / dptool / dpani.txt < prev    next >
Text File  |  1994-11-02  |  6KB  |  153 lines
  1.  
  2.                                 dpAni Reference
  3.  
  4.                               by Carl Chimes 1994
  5.  
  6.  
  7. WHAT IS DPANI
  8. =============
  9.  
  10. dpAni is a TSR which provides a *crude* animation facility within
  11. the IBM pc version of "Deluxe Paint II Enhanced v2.3" (DP).
  12.  
  13.  
  14. DOES DPANI WORK
  15. ===============
  16.  
  17. Since dpAni relies on certain DP functions and data being at
  18. absolute offsets within the DP program it is unlikely to work on
  19. all versions of Deluxe Paint. It may not even work on all copies of
  20. DP if modifications were made to the DP code during it's production.
  21.  
  22. But it certainly works for my copy. If you have v2.3 of Deluxe Paint II
  23. Enhanced you may be in luck.
  24.  
  25.  
  26. HOW TO USE DPANI
  27. ================
  28.  
  29. First (before running DP.EXE) run DPANI.COM.
  30. It outputs a simple usage message:
  31.  
  32.     dpAni by Carl Chimes 1994 : successfully installed
  33.     Keys in DeluxePaint IIE:
  34.       [F12] to activate (only works once per DP session)
  35.       [F11] pause/unpause animation
  36.       [GREYENTER] [ALT+KPNUMBER] set first frame nr (starting from 1)
  37.       [LEFTALT+GREYENTER] [ALT+KPNUMBER] set nr of frames
  38.       [LEFTALT+GREYUP] increase speed
  39.       [LEFTALT+GREYDOWN] decrease speed
  40.       [LEFTALT+GREYLEFT] single step backwards
  41.       [LEFTALT+GREYRIGHT] single step forwards
  42.       [LEFTALT+W] [ALT+KPNUMBER] set frame width (default 16)
  43.       [LEFTALT+H] [ALT+KPNUMBER] set frame height (default 16)
  44.       [LEFTALT+M] toggle multiblock (tessellation) mode
  45.       [LEFTALT+1] set Cycle animation type (default)
  46.       [LEFTALT+2] set Ramp animation type
  47.     Use "dpani" (from DOS) to install
  48.     Use "dpani /U" (from DOS) to uninstall
  49.     Use "dpani /?" (from DOS) for this help message
  50.  
  51. Then you run DP.
  52.  
  53. dpAni regards the screen as being a grid of pixmaps (bitmaps) each of which
  54. have the same width and height. The upper left pixmap has number 1, the one
  55. to it's right number 2, etc. The number of the leftmost pixmap on the i'th
  56. row is the number of the rightmost pixmap on the i-1'th row plus one. As you'd
  57. expect the number of pixmaps per row depends on the screen width and the pixmap
  58. width.
  59.  
  60. The animated pixmap is located in the lower left of the screen. The time
  61. between frames is actually a function of the frequency at which DP attempts
  62. to read a key from the BIOS (which is quite frequently and almost regularly),
  63. ie it is not attached to the ticker interrupt.
  64.  
  65.  
  66. Extra key commands are available while dpAni is running:
  67.  
  68. [F12]
  69.         Activates the dpAni TSR. You must press F12 (while DP is running) before
  70.         any other dpAni keys will work. If dpAni recognised DP it puts a blob
  71.         at the upper left corner of the status bar to let you know.
  72.         Even if a blob appears it doesn't mean that dpAni will necessarily
  73.         work - you must try the other commands to know for sure.
  74.  
  75. [F11]
  76.         Pauses/unpauses the animation. You must press this for the
  77.         animation to begin (after setting the first pixmap and length
  78.         of the animation sequence).
  79.  
  80. [GREYENTER] [ALT+KPNUMBER]
  81.         [GREYENTER] refers to the ENTER key on the keypad.
  82.         [ALT+KPNUMBER] means you hold ALT while typing in digits on
  83.         the keypad, then release ALT.
  84.         This command sets the pixmap number (numbered as above) of the
  85.         first pixmap in your animation sequence.
  86.  
  87. [LEFTALT+GREYENTER] [ALT+KPNUMBER]
  88.         [LEFTALT+GREYENTER] means you hold down the leftmost ALT key then
  89.         press the keypad ENTER then release the ALT key.
  90.         This command sets the quantity of pixmaps in your animation
  91.         sequence.
  92.  
  93. That should be enough to get you started. Experiment with the other commands
  94. listed above.
  95.  
  96.  
  97. CAVEATS
  98. =======
  99.  
  100. Sometimes dpAni will miss your keystrokes. If something didn't work retype
  101. the command.
  102.  
  103. Pixmaps are numbered from 1 instead of 0 because the BIOS does not report
  104. ALT+0. The maximum pixmap number possible is 255 regardless of how many can
  105. fit on the screen.
  106.  
  107. The width of your pixmaps must be byte aligned. In 256 color modes that means
  108. they can be any pixel width, in 16 color modes you're restricted to widths
  109. that are multiples of 8.
  110.  
  111. I've had memory problems while shelling to 4dos from qedit, running dpAni and
  112. running DP. Due to the inexperience of the author at writing TSRs it is not
  113. impossible that dpAni abuses DOS' memory allocation.
  114.  
  115.  
  116. FUTURE IMPROVMENTS
  117. ==================
  118.  
  119. I haven't any planned. Feel free to mutilate the source code to improve dpAni
  120. however you please. Some other subroutines and data locations in DP that may
  121. or may not have been identified correctly are listed in "addr.dp". See
  122. "dpani.asm" for how to use these (by example).
  123.  
  124. If anyone manages to work out how to tap into DP's GUI and can make a less
  125. user hostile front end for dpAni I would love to know about it!
  126.  
  127.  
  128. DISCLAIMER
  129. ==========
  130.  
  131. dpAni is provided "as is" without warranty, either express or implied. In
  132. particular any damage or loss suffered as a consequence of using this software
  133. is entirely at the user's expense.
  134.  
  135. Oh yes, anyone trying to profit from information about DP provided in dpAni may
  136. encounter legal problems with Electronic Arts. Apparently reverse engineering
  137. software is generally naughty.
  138.  
  139. However, since the little goblin who gave me this program assured me he
  140. disassembled DP for research purposes only, I guess I'm not liable. Beats
  141. me why he insisted I put my name on it.
  142.  
  143.  
  144. REQUEST
  145. =======
  146.  
  147. I would appreciate hearing from anyone with any other Deluxe Paint pc related
  148. utilities that they've made and wouldn't mind sharing.
  149.  
  150.  
  151. Carl Chimes,
  152. cs322552@dingo.cc.uq.oz.au
  153.